Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Getting and Playing Movies / Movie Posters and Movie Previews

SetTrackUsage

The SetTrackUsage function allows your application to specify whether a track is used in a movie, its preview, its poster, or a combination of these.

pascal void SetTrackUsage (Track theTrack, long usage);

theTrack

Specifies the track for this operation. Your application obtains this track identifier from such Movie Toolbox functions as NewMovieTrack and GetMovieTrack (described on page 2-136 and page 2-188, respectively).

usage

Contains flags that specify how the track is to be used. The following flags are defined (be sure to set unused flags to 0):

trackUsageInMovie

The track is used in the movie. If this flag is set to 1, the track is used in the movie.

trackUsageInPreview

The track is used in the preview. If this flag is set to 1, the track is used in the preview.

trackUsageInPoster

The track is used in the poster. If this flag is set to 1, the track is used in the poster.

ERROR CODES

invalidTrack

-2009

This track is corrupted or invalid

SEE ALSO

Your application can determine how a track is used by calling the GetTrackUsage function, which is described in the next section.